home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / printing / cnprint-.001 < prev    next >
Text File  |  1996-11-17  |  27KB  |  598 lines
  1. ***********************************************
  2. * CNPRINT.HELP For CNPRINT Versions 2.30/2.31 *
  3. ***********************************************
  4.  Copyright YIDAO CAI (~{2LR@5@~}), 1992, 1993  
  5.  All Rights Reserved.
  6.  Free for non-commercial and personal use only.
  7.  
  8. Disclaimer: Posting CNPRINT on any FTP site does not imply the author's
  9.     endorsement of the beliefs of the organization who owns the FTP site.
  10.  
  11. Last Revised on October 22, 1993
  12. -----------------------------------------------------------------------------
  13. PLEASE read parts 0 (What's New), II (what do you need), IV (First thing to 
  14.     do) and VI (Font) before compile, EVEN if you have used CNPRINT before.
  15.    ***  Cut off Appendix C and save it before print this document.
  16.    ***    Test with a small file the first time, or view the PS file on screen 
  17.     first, if possible. 
  18.    ***    If you encounter problem using CNPRINT, read part VII (known problems)  
  19.    ***  If you forgot the usage, type "cnprint" for quick on-line help.
  20.    ***  Users of CNPRINT V2.20/V2.21 do not need to get the HBF files and 
  21.     bitmap font files again, but need to update "cnprint.cmd".
  22. -----------------------------------------------------------------------------
  23.  
  24. CONTENT
  25. -----------------------------------------
  26. 0.    What Is CNPRINT and What's New
  27. I.    Functions and Features
  28. II.   What Do You Need to Use CNPRINT
  29. III.  Where to Get CNPRINT
  30. IV.   First Thing to Do
  31. V.    Usage
  32. VI.   Font Files
  33. VII.  Known Problems
  34. VIII. Author 
  35. IX.   Acknowledgements
  36. Appendix A, B, C
  37. -----------------------------------------
  38.  
  39. 0. What Is CNPRINT and What's New
  40.  
  41. CNPRINT, a utility to print Chinese text (or convert to PostScript) under 
  42.     DOS, VMS and UNIX systems.  It works just as a print command on 
  43.     your system.  Currently GB, Hz and BIG-5 formats are supported. 
  44.  
  45. These versions are updated from V2.20/V2.21.  New/improved features are 
  46. indicated by *.  Thanks to users for your valuable support and suggestions.
  47.  
  48. Main changes:
  49. 1. customized default settings in "cnprint.cmd", such as char size, margins,
  50.    character and line spaces, etc.
  51. 2. specify the space between columns.
  52. 3. created 4 modes for landscape printing l1, l2, l3 and l4, good for printing
  53.    HXWZ, save paper.  See V.(5) for details.
  54. 4. auto-detection of Big-5 file.
  55. 5. page-select options, possible to print only selected pages.
  56. 6. specify the PS print command on command line (Note: all "PS print command"
  57.    in this document refers to "PS print device port" if your system is DOS).
  58. 7. HBF environmental variable is changed to HBFPATH (this will also be used
  59.    by other softwares).
  60. 8. fixed some bugs.
  61.  
  62. Version 2.30 is for UNIX and VMS, Version 2.31 is for DOS.
  63.  
  64. I. Functions and Features
  65.  
  66.     1. Print GB/Hz/BIG-5 format Chinese text (or pure English text) 
  67.        or convert them to PostScript. (a, b)
  68.     *    2. Hz to GB or GB to Hz conversions. (c).
  69.     3. Small disk space requirement; PS file < 400K per issue of HXWZ.  
  70.     4. Support HBF, work with almost all bitmap font files with any
  71.        sizes.
  72.     5. Change font (character size) for a whole document, set font 
  73.        (character size) for a group of characters.
  74.     6. Multicolumn for a page or part of a page.
  75.     7. "Intelligent" treatment of punctuation marks.
  76.     8. Set gray level for a whole document or a group of characters.
  77.     9. Page numbering, change of margins.
  78.        10. Set paper orientation: Portrait or Landscape.
  79.        11. Vertical printing mode.
  80.        12. Change line space and character space and width of English chars.
  81.        13. Change English font.
  82.        14. Multiple copies of print-out.
  83.     *  15. User defined default values for margins, character size, etc.
  84.     *  16. Start a new page at any point (@[P#]).
  85.        17. Friendly designed so that even if you make a mistake the program 
  86.        would take care for you in most cases.
  87.  
  88. (a). SPEED of printing depends on printer and the number of characters in 
  89. a page (from 3-4 pages per minute to 1.5 minutes per page).  The fastest 
  90. reported so far is 135 seconds for one issue of HXWZ.  
  91.  
  92. (b). If one page, the PS file conforms to the Encapsulated PostScript file 
  93. format EPSF 3.0 and can be included in other documents (such as a Microsoft 
  94. Word document).  See part V for details.
  95.  
  96. (c). Simple Hz<->GB conversion for standard Hz/GB file.  For files that might
  97. contain bugs, F. F. Lee's hz2gb is suggested. 
  98.  
  99. II. What Do You Need to Use CNPRINT
  100.     A machine runing UNIX or VMS (V2.30), or an (IBM compatible) PC 
  101.         running DOS (V2.31)
  102.     A PostScript printer (CAUTION: NOT ordinary laser printer)
  103.     CNPRINT V?.??
  104.     One or more Chinese (HBF) font file(s) (see part VI)
  105.  
  106. III. Where to Get CNPRINT
  107.     site: ifcss.org
  108.     directory: /software/unix/print (cnprint230.c, cnprint230.readme)
  109.            /software/vms/print (cnprint230.exe, VMS only)
  110.            /software/dos/print (cnprint.doc, cnprint.exe, DOS only)
  111.            /software/fonts  (fonts)
  112.            /software/fonts/HBF  (HBF files)
  113. Note: 1. The /pub/software directory at cnd.org is a mirror of the /software
  114.     directory at ifcss.org.  You may also get the above files at cnd.org.
  115.       2. (UNIX only) There is a man file at /software/unix/man (compiled by 
  116.     Nelson Chin, butta1@cs.bu.EDU).
  117.       3. Get the following files according to your system (read part VI before
  118.     you get any font or HBF file).
  119.     VMS:    cnprint230.readme, cnprint230.exe, fonts, HBF files
  120.     UNIX:    cnprint230.readme, cnprint230.c, fonts, HBF files
  121.     DOS:    cnprint.doc, cnprint.exe, fonts, HBF files
  122.  
  123. IV. First Thing to Do
  124.  
  125.      1. There is a data file enclosed as Appendix C.  Please cut and save it 
  126.     as "cnprint.cmd" in the same directory where the fonts are kept (Note
  127.     CNPRINT can work without "cnprint.cmd", but some functions are lost).
  128.     In "cnprint.cmd", you need to 
  129.  
  130.     a. Specify the PS print command (device port) on your system. 
  131.     (DOS only:  the device port for printing PostScript files is most 
  132.     likely to be one of LPT1, LPT2, COM2, COM1.  Put "LPT2:" if it is 
  133.     LPT2.  Ask a local expert for help)
  134.  
  135.     WARNING: The print command (port) MUST be the command for printing
  136.         PostScript documents.  If you are NOT sure, please DO ask your
  137.         system manager, otherwise it could cause BIG problems. 
  138.  
  139.     If you do not specify the print command (port), CNPRINT would still 
  140.     generate PostScript file(s) but would not print it, you can then print
  141.     it by sending it to a PS printer.         
  142.  
  143.     b. Specify the default Big-5 font (HBF) file name in "cnprint.cmd" 
  144.     if you are going to print Big-5 documents. 
  145.  
  146.     c. If you are a user outside US, you may need to change the paper
  147.     size in "cnprint.cmd".  The default is A (8.5x11 inch).  For example,
  148.     if you use A4, you should change them to 8.27 and 11.69 respectively
  149.     (see Appendix A for paper sizes). 
  150.  
  151.      2. Specify the full path (directory) for the font files (NOT required,
  152.     but highly recommended).  If you do not specify the full path, you 
  153.     need to run CNPRINT under the directory you store the bitmap font 
  154.     file, HBF files and cnprint.cmd (they are assumed to be in the same 
  155.     directory).
  156.  
  157.     DOS: add a line in the "autoexec.bat" file: 
  158.  
  159.             HBFPATH=C:\FONT\  (if fonts is kept under dircetory C:\FONT)
  160.  
  161.     UNIX: use either a) or b) below (if you used both, b) has priority):
  162.  
  163.         a). set an environment variable HBFPATH (put it in your .cshrc file)
  164.  
  165.         setenv HBFPATH "~/your_subdir_for_fonts/"
  166.  
  167.         b). change line 28 of the source file and put your path there 
  168.  
  169.         #define CNLIB "<path>cnj24.hbf"
  170.  
  171.     VMS: You are recommended to follow steps in 4, although method b)
  172.         for UNIX also works.
  173.  
  174.     (NOTE: Other softwares may allow HBFPATH points to several paths, but
  175.         currently CNPRINT only uses the first one)
  176.  
  177.      3. (UNIX and VMS only) Compile the source program (there is no need to 
  178.     re-compile after making changes in "cnprint.cmd").  
  179.  
  180.     UNIX:    cc cnprint.c -o cnprint
  181.  
  182.         if this did not work, ask a local expert or your system manager.
  183.  
  184.     VMS: get "cnprint230.exe" directly.  If that did not work, you can
  185.         get cnprint.c and compile:
  186.  
  187.         cc cnprint
  188.         link cnprint
  189.         del cnprint.obj;*
  190.  
  191.     If this did not work, ask your system manager for help on how to
  192.     compile a C program.  CNPRINT may not work on old versions of VMS.
  193.     If you are using old versions of VMS, ask your system manager to 
  194.     update it.
  195.  
  196.      4.    (VMS only) You need to create a login file under your main directory
  197.     (or modify it if already exists).  The file name is "login.com" and
  198.     put two lines similar to the following in it:
  199.  
  200.     $cnprint :=="$mvsd:[cai.gb]cnprint.exe"
  201.     $HBFPATH :=="mvsd:[cai.gb.font]"
  202.  
  203.     here "mvsd" is my disk name; "[cai.gb]" and "[cai.gb.font]" are my
  204.     directories containing "cnprint.exe" and fonts respectively.  You 
  205.     should change them accordingly.  If this did not work, ask your
  206.     system manager for help on how to setup these things.
  207.  
  208. V. USAGE  
  209.  
  210.     For normal usage:    cnprint filename 
  211.     For help:         cnprint 
  212.         For extended usage:
  213.         cnprint [-h] [-z]  ... [-l] [-f font] filename [PS(GB)name]
  214.  
  215.     -h:    Help message
  216.      *    -5(-55): Input is Big-5 file (12)
  217.      *    -z(-zz)(-zzz): Hz to GB conversion only (4)
  218.     -w:    Convert GB/Hz to PS without printing (4)
  219.     -u:    Keep PS file after printing (4)
  220.     -x2:    Set character width/height 1.2  (2)
  221.     -y3:    Set character height/width 1.3  (2)
  222.     -p4:    Print/convert 4 pages at a time (8)
  223.      *    -c3(-c320): Divide one page into 3 columns (-c320, optionally specify 
  224.         the space between columns as 20 points, 1 point = 1/72 inch) 
  225.     -f font: Select font (2)
  226.      *    -l(-l3): Set paper orientation Landscape (5)
  227.      *    -j:    At the end of document, the printout does NOT go to the bottom
  228.         of a page if multicolumn
  229.     -v(-vv): Vertical printing (13)
  230.     -s:    Suppress the effects of the functional sequences @[**] (6) 
  231.     -t:    Do not print time and CNPRINT logo on the lower-left corner
  232.     -m3(-m): Print 3 copies of the document (do NOT display menu if -m)
  233.         (-m3m or -mm3 for both)
  234.      *    -hz:    Input is a Hz file, CNPRINT would not ask for conformation (7)
  235.      *    -a:    Print all CH alphabets and numbers as English ones (7)
  236.         (Note the definition of -a is changed)
  237.     -e56(-e): Set the width of English char 0.56 of that of Chinese char 
  238.         (Output is an EPS file if -e) (-e56e or -ee56 for both) (10)
  239.      *    -d:    Do -e5 and suppress the special treatment of punctuation 
  240.         marks (11)
  241.      *    -b3(e21): begin printing at page 3, and (optional) end printing at 
  242.         page 21 (14)
  243.      *    -o(-oo): print only odd-numbered or (-oo) even-numbered pages (14)
  244.      *    -q=laserps (DOS, -q=lpt2:): specify the PS print command as "laserps",
  245.         or in DOS, specify the PS print port name as "lpt2:" (15)
  246.  
  247. Note:   a. Most of the options can be combined.
  248.     b. The order is not important except "filename" must appear before
  249.        "PS(GB)name" (but need not appear consecutively)
  250. e.g.
  251.     cnprint -w -x2be10 filename 
  252.     cnprint -w -x2be10 filename PSname
  253.     cnprint -x2be10 filename -w PSname
  254.     cnprint -x2be10 filename -c2 PSname -q=laserps -o
  255.  
  256. 1. To set margins, line space, character space and character size for   
  257.     the WHOLE document, run CNPRINT and follow the menu instructions.
  258.     You can also set your preferred values in cnprint.cmd.
  259.  
  260. 2. To select font and character width-height ratio for the WHOLE document,
  261.     use -f, -x -y options above.  The use of -f option is 
  262.     
  263.     -f k24    or -f cnk24.hbf for 24x24 Kaishu font
  264.     -f f16    or -f cnf16.hbf for 16x16 Fanti font 
  265.     (see Part VI for meaning of k24, f16, etc)
  266.  
  267. ***Important*** It is recommended to set the font, line space, char space and 
  268.     char width/height used for the WHOLE document or majority of the 
  269.     document by -f, -x, -y or menu.  This would make the program much
  270.     more efficient.  
  271.  
  272. 3. To select font, character size, width-height ratio, line space, character 
  273.     space and width of English character for part of the document
  274.     (or a group of characters, even one character), or divide a page/part
  275.     of a page into several columns, insert the sequence @[**] in the text.
  276.     The meaning of **:
  277.     
  278.     @[f*] or @[F*]   select Chinese font, 16, 24, 48.  * is the font style 
  279.             code, see d).
  280.     @[v*] or @[V*]   select Chinese font, 40, 56, 64  (d)
  281.     @[h1] or @[H2]   select English font, normal (upright)
  282.     @[q3] or @[Q4]   select English font, italic/oblique (Xieti)
  283.                          capital H/Q: Bold; number 0-9 for different font, 
  284.              see menu at run time.
  285.  
  286.     @[18]    Integer number for character size in points.  1 point=0.355mm
  287.     @[X2]    Set character width/height 1.2
  288.     @[Y3]    Set character height/width 1.3
  289.     @[G2]    Set gray level 0.2, 0=black; 1=white
  290.     @[C2]    Select columns, i.e. divide the text into two columns
  291.  
  292.     @[E7]    Set width of English character 0.7 of that of Chinese char
  293.     @[Ix]   Set line space, x must be 0-9, a-f.  1-9 set the line space 
  294.         0.1-0.9 of the standard value and a-f set it 1-6 times of 
  295.         the standard value (standard value = 50% of char size) 
  296.     @[Ax]    Set character space, x must be 0-9, a-f.  1-f set the char
  297.         space 1-15 times of the standard value (standard value = 8% of 
  298.         char size)
  299.  
  300.     *    @[MVxxxyyy] Move current point to (xxx, yyy), allow you put text
  301.         anywhere on the page.  xxx, yyy are in points (1inch = 72pts)
  302.         and are relative to the upper-left corner of the text.  If 
  303.         (3, 25), put @[MV003025] instead of @[MV325] or @[MV 3 25].  
  304.         If xxx (or yyy) equals 001, then do NOT change x (y) position.
  305.         This is not designed to work with multicolumn at this stage 
  306.         so it may affect the column formatting.
  307.     *   @[P2]   If the current position is within 2 lines of the end of page,
  308.         start a new page.  If @[P0], start a new page immediately.
  309.         If used with multicolumn option, this command may produce 
  310.         effects some people don't like (while others may like).
  311.  
  312.      a. All the above letters, except fvhq, must be in upper case; 0 or 00 would
  313.     select the default value except in @[f*] or @[F*]. 
  314.  
  315.      b. Each of the above sequence would takes effect immediately and stop
  316.     only after the same nature of selection is choosed again.  For example,
  317.     if you select a character size 12 by @[12], it would remain 12 points
  318.     until you select another size, say 15 by @[15].  
  319.  
  320.      c. Column marker must begin at the beginning of a paragraph and must end 
  321.     at the end of a paragraph right after the hard return (i.e. the
  322.     beginning of next line, even if it is a blank line).
  323.  
  324.      d. To select font, you must specify font style by j, f, n, k, h, ...
  325.     or J, F, N, K, H, ... in the place of * in f* or F*.  The meaning of 
  326.     j, f... is j/J for Jianti, f/F for Fanti, etc (this is actually set 
  327.     by yourself, see the FONT part).  The font size are small (16x16), 
  328.     middle (24x24) and large (48x48).  To specify small size font, both
  329.     f* must be in lower case; to specify middle size font, one and only
  330.     one of f* or F* should be in lower case, the other in upper case.  
  331.     For example, @[fH] or @[Fh] both select 24x24 Heiti font, and @[ff] 
  332.     select 16x16 Fanti font.  Similar rules apply to 40x40, 56x56 and 
  333.     64x64 fonts (use v*, V* to select).
  334.  
  335.     ***    The metric information about English font is obtained from HP printers
  336.     and may NOT apply to other printers.  Besides, only printable 
  337.     characters are included.
  338.  
  339.      e. The program will use whatever character size, width/height ratio
  340.     right before the column maker @[C#] setting the parameters for the 
  341.     columns, so it is best to select the character size and width/height
  342.     ratio for most of the multicolumn portion right before the column
  343.     marker @[C#].
  344.  
  345. 4. If -w is selected, CNPRINT would generate a PS file but would not send
  346.     it to the printer.  -u would preserve the PS file after printing.  If
  347.     a PS file name is given, the PS file would be kept even if -u is not
  348.     selected.  The optional PS/GB name is taken as PS file name unless 
  349.     -z(z)(z) is selected.  (The next release will not support -u)
  350.     -zz:  GB -> Hz only; 
  351.     -zzz: GB/Big-5 -> GB/Big-5, filter out the functional sequences @[**].
  352.  
  353. 5. If you use -l to change paper orientation to Landscape, the default
  354.     character size is 12.2 pts (if width/height=1), and the page will be 
  355.     divided into 2 columns (to make it one column, use -lc1; -c1l would 
  356.     not work).
  357.    -l1, -l2, -l3, -l4:  select one of the sepecial landscape modes, the 
  358.     settings in "cnprint.cmd" will be suppressed.  These modes are 
  359.     designed for printing HXWZ (l1, l2) or LYTX (l3, l4).
  360.     
  361. 6. Option -s would suppress the effect of the functional sequence @[**] and
  362.     would not print it.  But if you want it printed, use -s# (# is any
  363.     single digit number and # > 2). 
  364.  
  365. 7. If you use -hz to tell CNPRINT that the input is a Hz file, CNPRINT would 
  366.     not ask for conformation.  But this is only optioanl for Hz file.
  367.      Notice that in previous versions this is done with -a.  Now -a has
  368.     new definitions, i.e. to change CH alphebits and numbers to English
  369.     ones.  This function was default in previous versions.  The reason
  370.     to make it optional is to keep the original style of text.
  371.      -aa: Input is a pure English text (some settings to make it look nice).
  372.  
  373. 8. If you do not have enough disk space (this is less likely to happen because
  374.     the PS file generated by CNPRINT is quite small), try -p# option.
  375.  
  376. 9. You MAY not need to wait until the print job finishes to press RETURN.  In
  377.     most machines, you can hit return after the print job is STARTed (not
  378.     just put on the queue). You can test this with a small file. 
  379.  
  380. 10. Default is -e5, i.e., the width of English char half of that of a Chinese
  381.     char.  But since CNPRINT still adjust the puctuations in this case, 
  382.     the print out may not be the same as you expected.  Try -d (see 11) 
  383.     if you need the text to line up.
  384.     If -e, the PS file conforms to EPSF-3.0 standard and can be included in 
  385.     other document such as Microsoft Word on PC (which I tested, may not 
  386.     work on others).  You can NOT display/preview it properly, but the 
  387.     final print-out is OK.  Use -we option to generate the PS file and 
  388.     name the PS file as *.eps.  Be sure to transfer the PS file as a TEXT
  389.     file but open it as an "eps" file.  You may want to adjust the 
  390.     BoundingBox: llx lly urx ury at line 4 in the PS file.  llx and lly 
  391.     are the x and y coordinates of the lower left corner, urx and ury are
  392.     the x and y coordinates of the upper right corner (relative to lower-
  393.     left corner of the paper).  The unit is points (1 inch = 72 points) 
  394.     and the numbers must be integer.
  395.     -e can also used to specify the page number to end printing, see (14).
  396.  
  397. 11. In this case, the output would be the SAME as what you see on the screen
  398.     when you edit the text IF you adjusted the number of characters in 
  399.     a line properly.  Also, you should select Courier (the default) for 
  400.     English font if you want the text to line up.  CNPRINT would not 
  401.     adjust the punctuation marks in this case.  For example, a comma (,)
  402.     may appear on the left end of a line.
  403.     Note, some popular Chinese editors treat TABs differently, but I believe 
  404.     the way CNPRINT does is the correct way.
  405.  
  406. 12. For Big-5 documents, adjustment of puctunation marks is disabled.  If you 
  407.     did not specify the default big-5 HBF file in "cnprint.cmd", you need
  408.     to specify font with -f option.  If -5 is selected twice (by -55 or 
  409.     -5 -5), some horizontal punctuations would be printed as their 
  410.     vertical counterparts in vertical mode and vice versa.  Although 
  411.     CNPRINT can detect Big-5 files automatically, it may fail in some 
  412.     extreme cases, so it is best to supply -5.
  413.     Note -e5 (-e55) is NOT interpreted as -e and -5 (-55), use -5e (-55e)
  414.     in this case.
  415.     
  416. 13. In vertical mode, adjustment of puctunation mark is disabled.  If document
  417.     is GB/Hz, selected symbol characters are rotated to make them appear 
  418.     better, and (if -v is selected twice by -vv or -v -v) some ASCII 
  419.     punctuations would be printed as their Chinese counterparts.  In both
  420.     GB and Big-5, if -v is selected twice, some punctuations are replaced
  421.     with better looking ones.
  422.     
  423. 14. These page numbers are the actual numbers that appear on the print-out, 
  424.     please make sure they do not conflict with the starting page number.
  425.         -b3e or -b3:    page 3 to end
  426.         -b3e8:      page 3 to page 8
  427.         -be21:      beginning to page 21
  428.         -b3e20o:      odd-numbered pages between 3 to 20
  429.     Note any -e option immeadiately following the -b option is considered to 
  430.     specify end-printing page number.  If the -e option is before the -b 
  431.     option or there are other options after -b but before -e, the -e
  432.     option is considered to be those defined in (10) above.     
  433.  
  434. 15. This would disable the PS print command (DOS: port name) in "cnprint.cmd".
  435.     Another way to enter the PS print command (port name) is to select -w
  436.     option on command line, then select P and answer YES in the menu.
  437.  
  438. 16. Default Setting
  439.     Input:        GB or Hz
  440.     Font:        Jianti 24x24 (cnj24.hbf)
  441.     Character Size:    14.5 pts (if width/height=1)  
  442.     Character Width/Height:    1.0
  443.     Paper Orientation: Portrait
  444.     Line Orientation:  Horizontal
  445.  
  446. VI. FONT FILES
  447.  
  448.     Please finish reading this part before using CNPRINT.  Skip it only 
  449. if you have used CNPRINT V2.20/V2.21 before.
  450.  
  451.     You need at least ONE font to run CNPRINT, and CNPRINT can use almost
  452. any HBF font.  If you do not have enough space, I suggest you get only one of 
  453. the following fonts.  The font-list below is only for the convenience of new 
  454. users.  For full list please see the README file under /software/fonts/HBF 
  455. directory.  All HBF files for bitmap font files with different style and size
  456. (both GB and Big-5) are stored in that directory.  Please read the README file
  457. under that directory before you get any bitmap font file or HBF file, and make
  458. sure the HBF file and the bitmap font file(s) match.
  459.  
  460.         (Bitmap font files)        (HBF files)
  461.     GB:    cclib.j24 (Jianti)        ccs24.hbf
  462.         cclib.f24 (Fanti)         ccs24f.hbf
  463.     Big-5:  kcchin24.f00 (Fanti)        kcm24.hbf
  464.  
  465.    NOTE: a). Get all bitmap font files in BINARY mode, HBF files in ASCII mode. 
  466.  
  467.      b). The bitmap font files, HBF files and "cnprint.cmd" should be put 
  468.     under the same directory.
  469.  
  470.      c). An HBF font consists of one or more existing bitmap files and 
  471.     one HBF file (See article about HBF carried on HXWZ #128, CM9309B).
  472.     You need to get both the bitmap files and the HBF files in order to
  473.     use CNPRINT.  CNPRINT requires (*) the name of the HBF file to be in 
  474.     the following format:
  475.  
  476.     cn*##.hbf
  477.  
  478.     where * can be any letter (a-z, use lower case if your system is 
  479.     case-sensitive, like unix) and ## be the number reflecting the size 
  480.     of the font, e.g. 24 for 24x24.  It is suggested that you make the 
  481.     letters meaningful, for example, 'k' for Kaishu, 'f' for Fanti.
  482.     * However, you can select an HBF file with ANY name on command line:
  483.         cnprint -f my_own.hbf filename ...
  484.  
  485.      d). After you get the HBF file, you NEED to rename them.  For example: 
  486.  
  487.         ccs24.hbf --> cnj24.hbf
  488.                 -----------------------
  489.  
  490.     For some non-square bitmap fonts, like kcchin16.f00, the HBF file is
  491.     named as kcm14.hbf, it is better to rename it as cnm16.hbf (i.e. use
  492.     numbers 16, 24, 48, 40, 56, 64).  If you name it as cnm14.hbf, you can
  493.     select it on command line with "-f m14", but you could not select it 
  494.     with @[f*].  Since CNPRINT gets the size information from the HBF file,
  495.     it is able to use fonts with any size.  For example, if you have a 
  496.     32x32 font and you name the HBF file as cnx56.hbf, it is still OK. 
  497.  
  498.     You can also write your own HBF file according to the HBF standard.  
  499.     Note CNPRINT only uses the simple properties.
  500.  
  501. VII. Known Problems 
  502.  
  503.      1. Q: The characters look alright but are not what it meant to be, or
  504.        are distorted, shifted up/down, left/right.
  505.     A1: Check HBF file, make sure it matches the bitmap font file.  If 
  506.        you write you own HBF file, make sure the offset information is
  507.        correct.
  508.     A2: The bitmap font is distorted in transmission.  Try to get it again,
  509.        using BINARY mode and transmit properly.
  510.     A3: You are printing a Big-5 file with GB fonts.
  511.  
  512.      2. Q: CNPRINT failed to print, but I saw the printer was processing 
  513.        the job.
  514.     A: It may be due to small memory on printer.  Try -n # option with 
  515.        smaller number (# = 1000 or less, default 2048) and contact author.  
  516.  
  517.      3. Q: CNPRINT only printed the first page.
  518.     A: It may be due to the way your printer is connected to the computer,
  519.        or the printer setup.  You can get around by using -p1 option, i.e. 
  520.        print one page at a time (it helps if you also use -n 200 with -p1 
  521.        if the document is large).
  522.  
  523.      4. (VMS and UNIX only) Some machines do not support the time functions,
  524.     then CNPRINT may stop running after displaying "*** Page 1 has been 
  525.     done ***".  In this is the case, you should change line 26 of cnprint.c 
  526.     from "#define  TIME 1" to "#define  TIME 0".  Or delete the lines
  527.     containing those unsupported functions.     
  528.     Some machines do not support function "remove()", just delete it.
  529.  
  530.      5. Q: (DOS) When I typed "cnprint ...", the computer hung up.
  531.        (VMS) When I typed "cnprint ...", strange messages were displayed
  532.         on the screen.
  533.  
  534.      A1: Did you get cnprint.exe or cnprint230.exe in BINARY mode ?
  535.     A2: (VMS) Did you follow the steps in IV (4) ?
  536.  
  537.      6. (DOS) Q: The message "Not enough memory" was displayed at some stage.
  538.     A: Disconnect network and other things and try CNPRINT again.  You 
  539.        may want to generate PS file only (use -w option) if your printer
  540.        is connected via network.
  541.  
  542.      7. (Big-5 only) Q: Some non-frequently used characters are not printed
  543.        correctly, but the frequently used chars or symbols are OK.
  544.     A: It is due to different versions of Big-5.  Try to match the 
  545.        font and the text, or use a conversion program, such as et2hku.
  546.  
  547. VIII. AUTHOR    
  548.  
  549.     cai@neurophys.wisc.edu
  550.     Yidao Cai (~{2LR@5@~})
  551.     Department of Neurophysiology
  552.     University of Wisconsin Medical School
  553.     1300 University Ave
  554.     Madison, WI 53706  USA
  555.     608-262-5899
  556.  
  557.     Please send suggestions and report bugs to the above address.  Please
  558.     include your e-mail address in the mail body as I sometimes could not
  559.     reach users with distorted e-mail addresses, and I understand those 
  560.     users need help the most because of their not-so-popular machines.
  561.     Thank you for using CNPRINT.
  562.  
  563.     The author will try his best to offer technical support.  However,
  564.     there is no warranty for CNPRINT.
  565.  
  566.     CNPRINT is free for non-commercial purpose and personal use only.
  567.     For any other use, please contact author.
  568.  
  569.     Donations in any ammount (suggested $5-$20) are more than welcome.
  570.     Your contributions will be solely used to establish an educational 
  571.     fund (in memory of my mother) to help and encourage children from 
  572.     rural areas with their primary and high school education.  Thanks
  573.     for your generous support. 
  574.     (You are equally welcome to contact author if you have questions and
  575.     you decide not to donate).  
  576.  
  577. IX. Acknowledgement
  578.  
  579.     Thanks to numerous users of previous versions for valuble suggestions
  580.     and encouragements, which make the continuous improvement of CNPRINT
  581.     possible.  In particular, I would like to mention Nelson Chin (butta1
  582.     @cs.bu.EDU), for both his suggestions and testing of V2.30 on his 
  583.     systems.  Some of the initial ideas came from the GB2PS Version 1.00 
  584.     of Dr. Wei Sun at william@anucsd.anu.edu.au.
  585.  
  586. Appendix A
  587. ----------
  588. paper sizes    
  589.     A:      8.5 x 11 inch  or  215.90 x 279.40 mm
  590.     A4:    8.27 x 11.69        210.00 x 297.00
  591.     B:       11 x 17           279.40 x 431.80
  592.     A3:   11.69 x 16.54        297.00 x 420.00    
  593.  
  594. Appendix B
  595. ----------
  596. Dr. F. F. LEE's hz2gb can be found at /software/unix/convert
  597. For HBF standard, see /software/fonts/HBF
  598.